Fast Async Load - configuration reference (EN)
==============================================

Config file:  <VaM>\BepInEx\config\org.vam.sceneloadopt.cfg
Created automatically on first launch. All keys are live-editable
(close the game, edit, restart). The plugin GUID is org.vam.sceneloadopt
and stays that way across renames - your settings survive upgrades.

--------------------------------------------------------------------------------
[General]
--------------------------------------------------------------------------------
Enabled                      true    Master switch. false = the plugin does
                                     absolutely nothing (no patches, no
                                     background work). Instant rollback.

--------------------------------------------------------------------------------
[PluginCache]
--------------------------------------------------------------------------------
Enabled                      true    Skip re-compiling scene plugins whose
                                     sources + options were already compiled
                                     and verified (type-set + byte signature).
                                     Any verification mismatch = compile
                                     normally (safe fallback).
LogKeys                      false   Log a compile key per compile (diagnostic).

--------------------------------------------------------------------------------
[ButtonPool]  - pool of pre-warmed objects instead of Instantiate on open
--------------------------------------------------------------------------------
Enabled                      true    Master switch for the pool.
TargetSize                   3500    Max pooled FileBrowser row instances.
MinPerPrefab                 16      Floor PER PREFAB (panel tabs etc.) even
                                     when TargetSize is already reached;
                                     otherwise row stacks eat the whole budget.
FillMs                       8       Refill wall-time budget per frame (ms).
                                     Keeps background refill from causing
                                     visible hitches with heavy prefabs.
RefillPerFrame               25      Max instances per refill wake (count cap,
                                     secondary to FillMs).
SkipFrameMs                  28      No refill in frames slower than this (ms).
LogStats                     true    Periodic pool summary (quiet when
                                     VerboseLog = false).

--------------------------------------------------------------------------------
[Spread]  - progressive list building and background UI generation
--------------------------------------------------------------------------------
Enabled                      true    Master switch for progressive lists,
                                     preview streaming and deferred heavy UI.
FirstFiles                   100     File rows built synchronously when a list
                                     opens (the rest stream in).
FirstDirs                    60      Directory rows built synchronously.
RowsPerFrame                 60      Rows appended per frame while filling the
                                     tail (the tail uses REAL element+button
                                     pairs - never placeholders).
SkipFrameMs                  40      No append work in frames slower than
                                     this (ms).
LogStats                     true    List open/completion stats (quiet when
                                     VerboseLog = false).
FirstPreviewVisible          48      Rows with an UNCACHED preview texture kept
                                     visible on open; the rest are activated
                                     progressively (spreads first-render GPU
                                     uploads).
PreviewPerFrame              12      Deferred preview rows activated per frame.
DeferHeavyUI                 true    First generation of color-picker textures,
                                     tag toggles and pagination buttons runs in
                                     the background (12 ms/frame budget); later
                                     generations run synchronously as usual.
                                     NEVER deferred during a scene load.
DeferBudgetMs                12      Background UI generation budget per frame
                                     (ms).

--------------------------------------------------------------------------------
[Diagnostics]
--------------------------------------------------------------------------------
VerboseLog                   false   false = quiet build (shipped): no [OPT]
                                     info/warning lines. true = full
                                     diagnostics: per-frame breakdowns of slow
                                     frames, slow-read paths, pool/deferred
                                     stats. Errors are logged either way.
Attribute                    true    Attribution hooks behind the diagnostics
                                     (needed by VerboseLog; harmless when
                                     quiet).
Continuous                   true    Attribute outside the load window too.
HitchDumpMs                  300     Dump a frame breakdown for frames slower
                                     than this (ms) when VerboseLog = true.
IncludeStartup               false   Also attribute the startup phase.
LogSummary                   true    One summary line when a scene load ends
                                     (shown only when VerboseLog = true).

--------------------------------------------------------------------------------
[TabSpread]  - legacy experimental progressive builder (kept for rollback)
--------------------------------------------------------------------------------
Enabled                      false   Off. Kept for historical rollback only.

--------------------------------------------------------------------------------
[Test]
--------------------------------------------------------------------------------
AutoLoadScene                false   TEST ONLY: auto-load a scene at startup.
ScenePath                    ...     TEST ONLY: scene for AutoLoadScene.
AutoLoadDelaySec             12      TEST ONLY: delay before auto-load.

--------------------------------------------------------------------------------
Warmup / Prefetch            false   Older experiments (shader warmup,
                                     background asset prefetch). Off by
                                     default; documented in the archive.

--------------------------------------------------------------------------------
Quick rollback examples (one line each)
--------------------------------------------------------------------------------
[General]     Enabled = false        everything off
[ButtonPool]  Enabled = false        vanilla Instantiate everywhere
[Spread]      Enabled = false        lists build in one frame again (vanilla)
[Spread]      DeferHeavyUI = false   pickers/toggles/pages synchronous again
[PluginCache] Enabled = false        plugins recompile every load (vanilla)
[Diagnostics] VerboseLog = true      turn full logging back on for debugging
